home *** CD-ROM | disk | FTP | other *** search
/ Professional Soft Collection 1.02 / Professional Soft Collection 1.02.iso / mpeg.os2 / pmmpeg.hlp (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1995-04-13  |  76.9 KB  |  1,921 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Summary of New Features ΓòÉΓòÉΓòÉ
  3.  
  4. I received a great deal of quality feedback from dozens of people that tried 
  5. previous releases of PMMPEG.  Here is a summary of new features that have been 
  6. implemented based on your suggestions.  Please continue to send suggestions and 
  7. bug reports, it will help to make PMMPEG better for everyone. 
  8.  
  9. Click on the links below to get more information on each feature. 
  10.  
  11. New Features in PMMPEG 3.0: 
  12.  
  13.      Added DIVE support.  This is the high-speed graphics and color conversion 
  14.       interface built into every video driver that ships with OS/2 Warp 3.0 
  15.       running with at least 256 colors. 
  16.  
  17.      Designed smaller icons in the toolbar to save screen space. 
  18.  
  19.      Redesigned the menus and added new options, as outlined below. 
  20.  
  21.      Added Registration feature.  Don't worry!  It gently reminds you to 
  22.       register each time the application starts up. There is no reduced 
  23.       functionality and none of your files is changed in any way. 
  24.  
  25.      Added Save current movie feature. 
  26.  
  27.      Added Half, Normal and Double size options. 
  28.  
  29.      Added Unlimited, Fast, Medium and Slow playback speed options. 
  30.  
  31.      Added an option to turn the menu/toolbar on and off.  When off, you can 
  32.       still access the menu and toolbar with a click of Mouse Button 2. 
  33.  
  34.      Added an option to maintain the aspect ratio during a resize of the 
  35.       playback frame. 
  36.  
  37.      Updated the status bar to show the movie size, frame rate and an 
  38.       indication of the movie type: I frame or IBP frame. 
  39.  
  40.      Redesigned the sizing scheme.  Removed the Small/Large button in the 
  41.       toolbar as you can resize the movie by resizing the frame to any size you 
  42.       like.  You can even Maximize it!  The Half, Normal and Double menu 
  43.       options help to get exact sizes with a click.  You can use the maintain 
  44.       the aspect ratio menu item to keep the movie properly proporationed as 
  45.       you resize it. 
  46.  
  47.      Moved all saved information out of the OS/2 INI file and into PMMPEG.INI, 
  48.       which lives in the same directory as the PMMPEG.EXE file. 
  49.  
  50.      Removed the Beep at the end of the movie. 
  51.  
  52.      Updated possible command line options. 
  53.  
  54.      Updated configuration data values saved between runs. 
  55.  
  56.      Updated popup panel when non-understood file is loaded. 
  57.  
  58.      Updated the popup message when no help file found more understandable. 
  59.  
  60.      Mentioned how to make Ultimotion movies with the VideoIn application from 
  61.       the OS/2 Warp 3.0 Bonus Pak. 
  62.  
  63.      Bug fix: Client was sized just a little too small, this has been fixed by 
  64.       virtue of the new sizing method. 
  65.  
  66.      Bug fix: No one discovered a latent bug where the Open File dialog would 
  67.       fail if a movie name was passed on the command line with a relative path. 
  68.  
  69.  New Features in PMMPEG 2.1: 
  70.  
  71.      Optimized playback speed with I/B/P movies.  They play at much higher 
  72.       frame rates and as a side effect the bug with stepping frame by frame in 
  73.       I/B/P movies has been corrected. 
  74.  
  75.      Added Slideshow feature.  This allows you to select multiple files with 
  76.       the File Dialog, drag/drop multiple files from somewhere on the desktop 
  77.       or specify multiple files on the command line.  PMMPEG will then play 
  78.       each movie, one after the other, and optionally loop back to the front of 
  79.       the list and play again if the Loop mode is set. 
  80.  
  81.      Added Toolbar buttons that allow you to save the current frame to the 
  82.       Clipboard or to an OS/2 Bitmap file 
  83.  
  84.      The Statistics dialog has been replaced by a Status bar that can be 
  85.       optionally displayed at the bottom of the frame.  This shows the relevant 
  86.       statistics for the movie: resolution, frame count (for I/B/P and 
  87.       displayed frames) and frame rate in frames/second. 
  88.  
  89.      If a decoding problem occurs on a particular frame, the status bar will 
  90.       optionally be displayed with a red background for that frame. 
  91.  
  92.      A pop up message will be displayed if the current display configuration 
  93.       is not set up for at least 256 colors This is required for proper display 
  94.       of the images. 
  95.  
  96.      Added WS_ANIMATE bit to respect system window animation option. 
  97.  
  98.      Update MPEG movie site information. 
  99.  
  100.      Added MPEG-2 decoder discussion to help file. 
  101.  
  102.      Added DIVE discussion/problems to help file. 
  103.  
  104.      Tested increasing color dithering space up from 128 colors but there was 
  105.       not much visual difference and performance suffered. 
  106.  
  107.      Optimization: Check and don't change a button if it's already in the 
  108.       required state. 
  109.  
  110.      Optimization: Quickly skip initial frames until a non-all-black frame is 
  111.       found.  This will always display the first valid frame of any movie. 
  112.  
  113.      Optimization: Better frame/second calculation, still mildly optimistic. 
  114.  
  115.      Bug fix: Leaves movie positioned at last frame when it ends. 
  116.  
  117.      Bug fix: Only one error message on improper end sequence, stops 
  118.       gracefully. 
  119.  
  120.      Bug fix: Gets focus on startup as it should. 
  121.  
  122.      Bug fix: Fixed memory leaks and optimized internal table use. 
  123.  
  124.      Internal: Cleaned up compiler warnings in source, removed dead code. 
  125.  
  126.      Internal: Removed frame size calculation hack. 
  127.  
  128.  New Features in PMMPEG 2.0: 
  129.  
  130.      Toolbar with tape controls (Play/Stop/Rewind/Step/Size/Color/Loop) 
  131.  
  132.      Accept MPEG filename on command line and automatically play it. 
  133.  
  134.      Command line options for playback size, color and looping. 
  135.  
  136.      Configuration data saved between runs. 
  137.  
  138.      INSTALL.CMD will create a PMMPEG desktop object 
  139.  
  140.      INSTALL.CMD will associate PMMPEG with all *.MPG files 
  141.  
  142.      Drag/Drop MPEG movie onto PMMPEG. 
  143.  
  144.      Double size playback is possible both in Color and Grayscale. 
  145.  
  146.      Loading a movie decodes and displays the first valid frame. 
  147.  
  148.      When the window is obscured and then revealed, the movie frame is 
  149.       repainted. 
  150.  
  151.      New MPEG movie sites added and corrections made to list. 
  152.  
  153.      File Dialog always brings up *.MPG. 
  154.  
  155.      MPEG filename is now displayed in the Title bar. 
  156.  
  157.      Bug fix: no more silent death problem.  PMMPEG jumps to the next frame 
  158.       when bad encoding detected. 
  159.  
  160.      Bug fix: The file handle is closed when a movie fails parsing as non-MPEG 
  161.       format 
  162.  
  163.      Bug fix: Popups are now displayed on fatal read/MPEG stream/parsing 
  164.       errors. 
  165.  
  166.  
  167. ΓòÉΓòÉΓòÉ 2. Suggestions for Future Releases ΓòÉΓòÉΓòÉ
  168.  
  169. Here is the list of features I was not able to add in time for this release. 
  170. If you have any more features you'd like to see, please send them to me. 
  171.  
  172. I can't promise to eventually implement them all, due to constraints like time, 
  173. Berkeley decoding engine limitations, etc., but I'll do my best. 
  174.  
  175. The list is in a rough order of what I think I'll concentrate on. 
  176.  
  177.      Provide an OS/2 for PowerPC executable shortly after the projected April 
  178.       1995 OS/2 for PowerPC Beta is released.  I have build the code with the 
  179.       limited December 1994 OS/2 for PowerPC beta, but decided against it 
  180.       because of the limited distribution, stability and performance.  I expect 
  181.       great things from the upcoming Beta. 
  182.  
  183.      Provide an MPEG part for OpenDoc.  I had it working at one point and it 
  184.       only took about 2 days to convert the conventional PM program.  OpenDoc 
  185.       has matured greatly since then but I wanted to get this release out 
  186.       quickly as people have been waiting long enough.  I'll ship the OpenDoc 
  187.       part as soon as I get updated toolkits, samples, etc. and have the time 
  188.       to do the port. 
  189.  
  190.      Support a play list - a file containing a list of MPEG files to be 
  191.       played. 
  192.  
  193.      Save all frames of movie as bitmaps with unique names with a single 
  194.       click. 
  195.  
  196.      Move bottom of window when status bar is toggled, instead of top. 
  197.  
  198.      Ensure window stays completely on desktop when toggling status or size 
  199.       buttons. 
  200.  
  201.      Save bitmaps as RLE, optional as some apps don't like RLE encoding. 
  202.  
  203.      Allow priority adjustment. 
  204.  
  205.      Display any interesting info from the MPEG header. 
  206.  
  207.      REXX hooks for external control of behavior. 
  208.  
  209.      Further Optimize decoding/dithering to improve frame rate. 
  210.  
  211.      Overlap display/decode of frames to speed throughput. 
  212.  
  213.      Frame back (I frame only). 
  214.  
  215.      Play at encoded speed, some movies go too fast. 
  216.  
  217.      Scroll bar back and forth across frames. 
  218.  
  219.      Pre-parse file and then play back frames. 
  220.  
  221.      Bar graph timeline. 
  222.  
  223.      Audio sync. 
  224.  
  225.      Make into MMPM/2 codec. 
  226.  
  227.  
  228. ΓòÉΓòÉΓòÉ 3. Non-Understood Files ΓòÉΓòÉΓòÉ
  229.  
  230. When you select a file with the Open... menu item or Drag and Drop a file or 
  231. group of files onto the movie window, PMMPEG may pop up a message that it 
  232. doesn't understand the file.  There are a few reasons for this: 
  233.  
  234.      It may really be a non-MPEG file. 
  235.  
  236.      It could be an MPEG-1 file with interleaved sound.  These files seem to 
  237.       have a defacto extension of .mp2 and are found at music sites around the 
  238.       Internet.  PMMPEG does not support any MPEG files with interleaved sound 
  239.       at this time. 
  240.  
  241.      It could be an MPEG-2.  PMMPEG does not support MPEG-2 at this time. 
  242.  
  243.  
  244. ΓòÉΓòÉΓòÉ 4. VideoIn ΓòÉΓòÉΓòÉ
  245.  
  246. The OS/2 Warp 3.0 Bonus Pak includes an application called VideoIn that won the 
  247. Best Product award at COMDEX.  Among other things, it can build an Ultimotion 
  248. file from a series of bitmaps.  Ultimotion is the native video file format for 
  249. OS/2. 
  250.  
  251. If you step through your movie and save each frame into a bitmap file, you'll 
  252. be able to make an Ultimotion file from it.  VideoIn will even let you add 
  253. sound to the file and playback will stay in sync with the audio. 
  254.  
  255.  
  256. ΓòÉΓòÉΓòÉ 5. Toolbar ΓòÉΓòÉΓòÉ
  257.  
  258. Use the buttons on the toolbar to control the playback of the movie and select 
  259. playback options. 
  260.  
  261. The buttons on the toolbar have the following functions: 
  262.  
  263.      The Play Button causes the movie to start playing. 
  264.  
  265.      The Stop Button causes the movie to stop playing. 
  266.  
  267.      The Rewind Button causes the movie to be rewound to the first frame, 
  268.       ready for a subsequent Play or Step. 
  269.  
  270.      The Step Button button causes the next frame of the movie to be 
  271.       displayed. 
  272.  
  273.      The Clipboard Button causes the image of the currently displayed frame to 
  274.       be copied to the OS/2 clipboard. 
  275.  
  276.      The File Button causes the image of the currently displayed frame to be 
  277.       saved to an OS/2 bitmap file on disk. 
  278.  
  279.      The Color/Gray Button can be either in Color or Grayscale mode. 
  280.  
  281.         -  When in the Color state, the movie is played at the color setting of 
  282.            your desktop; generally 256, 64K or 16.7M colors. 
  283.  
  284.         -  When in the Gray state, the movie is played in shades of gray, the 
  285.            number of shades depend on the color setting of your desktop. 
  286.            Grayscale plays movies a little faster than Color because there's 
  287.            less work to do. 
  288.  
  289.      The NoLoop/Loop Button button can be either in NoLoop or Loop mode. 
  290.  
  291.         -  When in the NoLoop state, the movie is played once and then halts at 
  292.            the end. 
  293.  
  294.         -  When in the Loop state, the movie is played over and over until you 
  295.            click on the Stop button or drag and drop a new movie onto the 
  296.            window. 
  297.  
  298.  
  299. ΓòÉΓòÉΓòÉ 5.1. Play Button ΓòÉΓòÉΓòÉ
  300.  
  301. The Play button causes the movie to start playing.  When the movie starts 
  302. playing, the Stop button will be enabled and the Rewind and Step buttons will 
  303. be disabled. 
  304.  
  305.      If there is no movie loaded, the button will be in this grayed out state: 
  306.  
  307.      If there is a movie loaded and it's not currently playing, the button 
  308.       will be in this enabled state: 
  309.  
  310.      If there is a movie loaded and it is currently playing, the button will 
  311.       be in this grayed out state: 
  312.  
  313.  
  314. ΓòÉΓòÉΓòÉ 5.2. Stop Button ΓòÉΓòÉΓòÉ
  315.  
  316. The Stop button causes the movie to stop playing.  When the movie stops 
  317. playing, the Play, Rewind and Step buttons will be enabled. 
  318.  
  319.      If there is no movie loaded, the button will be in this grayed out state: 
  320.  
  321.      If there is a movie loaded and it's not currently playing, the button 
  322.       will be in this grayed out state: 
  323.  
  324.      If there is a movie loaded and it is currently playing, the button will 
  325.       be in this enabled state: 
  326.  
  327.  
  328. ΓòÉΓòÉΓòÉ 5.3. Rewind Button ΓòÉΓòÉΓòÉ
  329.  
  330. The Rewind button causes the movie to be rewound to the first frame, ready for 
  331. a subsequent Play or Step. 
  332.  
  333.      If there is no movie loaded, the button will be in this grayed out state: 
  334.  
  335.      If there is a movie loaded and it's not currently playing, the button 
  336.       will be in this enabled state: 
  337.  
  338.      If there is a movie loaded and it is currently playing, the button will 
  339.       be in this grayed out state: 
  340.  
  341.  
  342. ΓòÉΓòÉΓòÉ 5.4. Step Button ΓòÉΓòÉΓòÉ
  343.  
  344. The Step button causes the next frame of the movie to be displayed. If the end 
  345. of the movie is encountered, it will be rewound to the first frame and stepping 
  346. can continue without reloading the movie. 
  347.  
  348. There is a known problem when using Step with IBP-Frame Movies 
  349.  
  350.      If there is no movie loaded, the button will be in this grayed out state: 
  351.  
  352.      If there is a movie loaded and it's not currently playing, the button 
  353.       will be in this enabled state: 
  354.  
  355.      If there is a movie loaded and it is currently playing, the button will 
  356.       be in this grayed out state: 
  357.  
  358.  
  359. ΓòÉΓòÉΓòÉ 5.5. Clipboard Button ΓòÉΓòÉΓòÉ
  360.  
  361. This button allows you to save the curently displayed frame into the clipboard. 
  362. This allows other OS/2 (and smart Windows) applications to copy the bitmap out 
  363. of the clipboard for later use.  Such apps might allow you to touch up the 
  364. image or add text to it, then save to any one of many image file formats. 
  365.  
  366.      If there is no movie loaded, the button will be in this grayed out state: 
  367.  
  368.      If there is a movie loaded and it's not currently playing, the button 
  369.       will be in this enabled state: 
  370.  
  371.      If there is a movie loaded and it is currently playing, the button will 
  372.       be in this grayed out state: 
  373.  
  374.  
  375. ΓòÉΓòÉΓòÉ 5.6. File Button ΓòÉΓòÉΓòÉ
  376.  
  377. This button allows you to save the curently displayed frame as a 256 color 
  378. non-RLE OS/2 bitmap file.  It will attempt to generate a unique filename based 
  379. on the movie filename and the current frame number. If you're saving the file 
  380. to a FAT formatted partition, the initial filename may have too many 
  381. characters.  Simply shorten the first part of the bitmap filename so it fits 
  382. the 8.3 naming convention.  Subsequent attempts to save the bitmap to a file 
  383. will use the altered name, replacing the frame number with the new frame 
  384. number. 
  385.  
  386.      If there is no movie loaded, the button will be in this grayed out state: 
  387.  
  388.      If there is a movie loaded and it's not currently playing, the button 
  389.       will be in this enabled state: 
  390.  
  391.      If there is a movie loaded and it is currently playing, the button will 
  392.       be in this grayed out state: 
  393.  
  394.  
  395. ΓòÉΓòÉΓòÉ 5.7. Color/Gray Button ΓòÉΓòÉΓòÉ
  396.  
  397. The Color/Gray button toggles back and forth between color playback and 
  398. shades-of-gray playback. 
  399.  
  400. This button defaults to Color, but can be changed by options on the command 
  401. line or the configuration data in force when this program was last shut down. 
  402.  
  403. You will usually see slightly better frame rates with Gray than with Color due 
  404. to the simpler dithering calculations.  Also, some movies have "garish" color 
  405. and selecting gray scale will make them more pleasing to the eye. 
  406.  
  407. There is a problem with the Color Table when switching from color->gray or 
  408. gray->color during playback. 
  409.  
  410. Note: You can toggle this while the movie is running and the display will 
  411. change to the desired color scheme. 
  412.  
  413.      When in the Color state , the movie is played in color.  If in DIVE mode, 
  414.       it uses the full number of colors running on your desktop.  If in 
  415.       non-DIVE mode, it uses 128 colors. 
  416.  
  417.      When in the Grayscale state , the movie is played in shades of gray. 
  418.  
  419.  
  420. ΓòÉΓòÉΓòÉ 5.8. NoLoop/Loop Button ΓòÉΓòÉΓòÉ
  421.  
  422. The NoLoop/Loop button toggles back and forth between playing the movie and 
  423. looping around to the start and playing again or playing the movie and stopping 
  424. at the end. 
  425.  
  426. This button defaults to NoLoop, but can be changed by options on the command 
  427. line or the configuration data in force when this program was last shut down. 
  428.  
  429. Note: You can toggle this while the movie is running and the movie will behave 
  430. accordingly when it hits the last frame. 
  431.  
  432.      When in the NoLoop state , the movie stops when it hits the last frame. 
  433.  
  434.      When in the Loop state , the movie loops around to the start and 
  435.       continues playing when it hits the last frame. 
  436.  
  437.  
  438. ΓòÉΓòÉΓòÉ 6. Configuration Data ΓòÉΓòÉΓòÉ
  439.  
  440. PMMPEG stores information about itself when you quit so it can try to give you 
  441. the same environment the next time you run it. 
  442.  
  443.      Window position on the desktop is saved and restored, even if maximized 
  444.       or minimized. 
  445.  
  446.      Window size is saved and restored. 
  447.  
  448.      Color / Gray state is saved and restored. 
  449.  
  450.      Loop / No Loop state is saved and restored. 
  451.  
  452.      DIVE / No DIVE state is saved and restored. 
  453.  
  454.      Status Bar / No Status Bar state is saved and restored. 
  455.  
  456.      Bad Encoding Message / No Bad Encoding Message state is saved and 
  457.       restored. 
  458.  
  459.      Menu/Toolbar / No Menu/Toolar state is saved and restored. 
  460.  
  461.      Maintain Aspect Ratio / No Maintain Aspect Ratio state is saved and 
  462.       restored. 
  463.  
  464.      Half size / Normal Size / Double size state is saved and restored. 
  465.  
  466.      Slow / Medium / Fast / Unlimited playback speed state is saved and 
  467.       restored. 
  468.  
  469.      The last directory path a movie is loaded from is saved and restored. 
  470.  
  471.      The last directory path a movie frame is saved to is saved and restored. 
  472.  
  473.  If you simply launch PMMPEG without any command line options, these values 
  474.  will be loaded and used to set up the player just like it was when you quit it 
  475.  last.  You can use command line options which will override these saved 
  476.  values. 
  477.  
  478.  
  479. ΓòÉΓòÉΓòÉ 7. Command Line Options ΓòÉΓòÉΓòÉ
  480.  
  481. PMMPEG has been enhanced to take a number of options on the command line, 
  482. allowing its use as an object on the desktop or as part of a program like the 
  483. OS/2 Warp 3.0 Bonus Pak application WebExplorer which attempts to pass the 
  484. filename of an MPEG movie on the command line. 
  485.  
  486. These are the recognized command line options: 
  487.  
  488.      -color Color playback, default. 
  489.  
  490.      -gray Grayscale playback. 
  491.  
  492.      -noloop One play playback, default. 
  493.  
  494.      -loop Looping playback. 
  495.  
  496.      -dive Use DIVE -enabled playback, default. 
  497.  
  498.      -nodive Use conventional GpiBitBlt playback. 
  499.  
  500.      -status Show the status bar , default. 
  501.  
  502.      -nostatus Do not show the status bar 
  503.  
  504.      -encmsg Indicate in the status bar when an encoding error is detected in 
  505.       the MPEG file. 
  506.  
  507.      -noencmsg Ignore any encoding errors in the MPEG file, default. 
  508.  
  509.      -toolbar Show the menu/toolbar , default. 
  510.  
  511.      -notoolbar Do not show the menu/toolbar 
  512.  
  513.      -aspect Maintain the aspect ratio during a resize of the movie window, 
  514.       default. 
  515.  
  516.      -noaspect Do not maintain the aspect ratio during a resize of the movie 
  517.       window. 
  518.  
  519.      -half Resize the window to half the normal movie size. 
  520.  
  521.      -normal Resize the window to the normal movie size, default. 
  522.  
  523.      -double Resize the window to double the normal movie size. 
  524.  
  525.      -slow Play the movie at the slow setting. 
  526.  
  527.      -medium Play the movie at the medium setting. 
  528.  
  529.      -fast Play the movie at the fast setting. 
  530.  
  531.      -unlimited Play the movie at the unlimited setting, default. 
  532.  
  533.      filename(s) Filename(s) of movies to load and play. 
  534.  
  535.  If one or more filenames are given on the command line, either by explicitly 
  536.  listing multiple filenames or using a wildcard pattern with * or ?, they will 
  537.  be loaded and play started automatically. 
  538.  
  539.  Note that the following options are mutually exclusive.  You're only allowed 
  540.  to choose one from each of the following groups: 
  541.  
  542.      -color and -gray 
  543.  
  544.      -noloop and -loop 
  545.  
  546.      -dive and -nodive 
  547.  
  548.      -status and -nostatus 
  549.  
  550.      -encmsg and -noencmsg 
  551.  
  552.      -toolbar and -notoolbar 
  553.  
  554.      -aspect and -noaspect 
  555.  
  556.      -half, -normal and -double 
  557.  
  558.      -slow, -medium -fast and -unlimited 
  559.  
  560.  If more than one of any of these pairs is listed on the command line, the one 
  561.  closest to the end of the command line will take precedence. 
  562.  
  563.  If any of these options are specified, they will take precedence over the 
  564.  information saved from the last time.  Therefore, if you want to be sure that 
  565.  you get a particular option, it's better to explicitly mention it on the 
  566.  command line. 
  567.  
  568.  
  569. ΓòÉΓòÉΓòÉ 7.1. -color option ΓòÉΓòÉΓòÉ
  570.  
  571. The -color option causes PMMPEG to start up in color mode. 
  572.  
  573.  
  574. ΓòÉΓòÉΓòÉ 7.2. -gray option ΓòÉΓòÉΓòÉ
  575.  
  576. The -gray option causes PMMPEG to start up in shades of gray mode. 
  577.  
  578.  
  579. ΓòÉΓòÉΓòÉ 7.3. -noloop option ΓòÉΓòÉΓòÉ
  580.  
  581. The -noloop option causes PMMPEG to start up in play-once-and-stop mode. 
  582.  
  583.  
  584. ΓòÉΓòÉΓòÉ 7.4. -loop option ΓòÉΓòÉΓòÉ
  585.  
  586. The -loop option causes PMMPEG to start up in continuous loop mode. 
  587.  
  588.  
  589. ΓòÉΓòÉΓòÉ 7.5. -dive option ΓòÉΓòÉΓòÉ
  590.  
  591. The -dive option causes PMMPEG to display movies using DIVE support. 
  592.  
  593.  
  594. ΓòÉΓòÉΓòÉ 7.6. -nodive option ΓòÉΓòÉΓòÉ
  595.  
  596. The -nodive option causes PMMPEG to display movies using the conventional 
  597. GpiBitBlt graphics output. 
  598.  
  599.  
  600. ΓòÉΓòÉΓòÉ 7.7. -status option ΓòÉΓòÉΓòÉ
  601.  
  602. The -status option causes PMMPEG to display the status bar during movie 
  603. playback. 
  604.  
  605.  
  606. ΓòÉΓòÉΓòÉ 7.8. -nostatus option ΓòÉΓòÉΓòÉ
  607.  
  608. The -nostatus option causes PMMPEG to not display the status bar during movie 
  609. playback. 
  610.  
  611.  
  612. ΓòÉΓòÉΓòÉ 7.9. -encmsg option ΓòÉΓòÉΓòÉ
  613.  
  614. The -encmsg option causes PMMPEG to display a notification of bad frames in the 
  615. movie. 
  616.  
  617.  
  618. ΓòÉΓòÉΓòÉ 7.10. -noencmsg option ΓòÉΓòÉΓòÉ
  619.  
  620. The -noencmsg option causes PMMPEG to not display a notification of bad frames 
  621. in the movie. 
  622.  
  623.  
  624. ΓòÉΓòÉΓòÉ 7.11. -toolbar option ΓòÉΓòÉΓòÉ
  625.  
  626. The -toolbar option causes PMMPEG to display the menu bar and toolbars in the 
  627. movie frame. 
  628.  
  629.  
  630. ΓòÉΓòÉΓòÉ 7.12. -notoolbar option ΓòÉΓòÉΓòÉ
  631.  
  632. The -notoolbar option causes PMMPEG to not display the menu bar and toolbars in 
  633. the movie frame. 
  634.  
  635.  
  636. ΓòÉΓòÉΓòÉ 7.13. -aspect option ΓòÉΓòÉΓòÉ
  637.  
  638. The -aspect option causes PMMPEG to maintain the aspect ratio during movie 
  639. window resize. 
  640.  
  641.  
  642. ΓòÉΓòÉΓòÉ 7.14. -noaspect option ΓòÉΓòÉΓòÉ
  643.  
  644. The -noaspect option causes PMMPEG to not maintain the aspect ratio during 
  645. movie window resize. 
  646.  
  647.  
  648. ΓòÉΓòÉΓòÉ 7.15. -half option ΓòÉΓòÉΓòÉ
  649.  
  650. The -half option causes PMMPEG to play the movie back at half size. 
  651.  
  652.  
  653. ΓòÉΓòÉΓòÉ 7.16. -normal option ΓòÉΓòÉΓòÉ
  654.  
  655. The -normal option causes PMMPEG to play the movie back at normal size. 
  656.  
  657.  
  658. ΓòÉΓòÉΓòÉ 7.17. -double option ΓòÉΓòÉΓòÉ
  659.  
  660. The -double option causes PMMPEG to play the movie back at double size. 
  661.  
  662.  
  663. ΓòÉΓòÉΓòÉ 7.18. -slow option ΓòÉΓòÉΓòÉ
  664.  
  665. The -slow option causes PMMPEG to play the movie back at slow speed. 
  666.  
  667.  
  668. ΓòÉΓòÉΓòÉ 7.19. -medium option ΓòÉΓòÉΓòÉ
  669.  
  670. The -medium option causes PMMPEG to play the movie back at medium speed. 
  671.  
  672.  
  673. ΓòÉΓòÉΓòÉ 7.20. -fast option ΓòÉΓòÉΓòÉ
  674.  
  675. The -fast option causes PMMPEG to play the movie back at fast speed. 
  676.  
  677.  
  678. ΓòÉΓòÉΓòÉ 7.21. -unlimited option ΓòÉΓòÉΓòÉ
  679.  
  680. The -unlimited option causes PMMPEG to play the movie back at unlimited speed. 
  681.  
  682.  
  683. ΓòÉΓòÉΓòÉ 7.22. filename option ΓòÉΓòÉΓòÉ
  684.  
  685. The filename option causes PMMPEG to load and start playing that MPEG movie 
  686. automatically. 
  687.  
  688.  
  689. ΓòÉΓòÉΓòÉ 8. Installation ΓòÉΓòÉΓòÉ
  690.  
  691. PMMPEG can simply be run in any of the following manners: 
  692.  
  693.      On the command line, type pmmpeg with any desired options or MPEG 
  694.       filenames. 
  695.  
  696.      Double-click on the PMMPEG object on your desktop. 
  697.  
  698.      Double-click on any .MPG files in any folder. 
  699.  
  700.  The second and third options are enabled for you if you run the INSTALL.CMD 
  701.  REXX program supplied with PMMPEG. 
  702.  
  703.  
  704. ΓòÉΓòÉΓòÉ 8.1. INSTALL.CMD ΓòÉΓòÉΓòÉ
  705.  
  706. INSTALL.CMD is a REXX program that will create a PMMPEG desktop object for you 
  707. and set up an association. for any files that end in .MPG. 
  708.  
  709. For this to work properly under OS/2 Warp 3.0, you must first remove the 
  710. default installation association with the following procedure: 
  711.  
  712.      Open the Drives folder and go to the mmos2 directory of your OS/2 
  713.       partition. 
  714.  
  715.      Open the settings panel of MMPM.EXE and go to the Associations page. 
  716.  
  717.      Find *.MPG in the list of file extensions at the bottom of the page 
  718.  
  719.      Click on *.MPG, then click on Remove. 
  720.  
  721.  If anyone would like to write the REXX code to do this automatically, please 
  722.  email it to me and I'll include it in the next release of PMMPEG and make you 
  723.  famous by putting your name here! 
  724.  
  725.  Now make sure PMMPEG.EXE and INSTALL.CMD are located in the directory where 
  726.  you are going to keep PMMPEG.EXE.  Then type INSTALL at the command line. It 
  727.  will create a desktop object and make the association with all .MPG files on 
  728.  your system. 
  729.  
  730.  If you choose to make your own icon for PMMPEG, click here 
  731.  
  732.  
  733. ΓòÉΓòÉΓòÉ 8.2. PMMPEG Desktop Object ΓòÉΓòÉΓòÉ
  734.  
  735. To get this feature, follow the INSTALL.CMD procedure.  This will make a PMMPEG 
  736. object on your desktop that looks like this: 
  737.  
  738. If you double-click on this object, it will launch PMMPEG.  You can add any of 
  739. the command line options you like to the Parameters: field of the Program page 
  740. of its Settings notebook. 
  741.  
  742.  
  743. ΓòÉΓòÉΓòÉ 8.3. .MPG Movie Association ΓòÉΓòÉΓòÉ
  744.  
  745. OS/2's Workplace Shell has a feature that allows programs to be automatically 
  746. launched when a data file using that executable is double-clicked on.  This 
  747. helps us because it allows all MPEG files to be played by PMMPEG just by 
  748. double-clicking on their icons. 
  749.  
  750. OS/2 Warp 3.0 has a peculiar feature that associates all *.MPG file with a 
  751. Bonus Pak application that won't work properly if you don't have a ReelMagic 
  752. MPEG hardware card installed!  To have PMMPEG properly associated with all 
  753. *.MPG files, follow the INSTALL.CMD procedure. 
  754.  
  755. Now all MPEG files ending in .MPG on your system should have their icon set to 
  756. the PMMPEG icon: 
  757.  
  758. When you double-click on an MPEG movie, it will launch PMMPEG and automatically 
  759. start playing the selected movie. 
  760.  
  761.  
  762. ΓòÉΓòÉΓòÉ 9. Drag and Drop MPEG Movies ΓòÉΓòÉΓòÉ
  763.  
  764. PMMPEG has been designed to allow dragging one or more MPEG movies from a 
  765. folder on the desktop to the PMMPEG window. 
  766.  
  767. If you attempt to drop a non-MPEG movie (i.e. not ending in .MPG) the drop will 
  768. be rejected. 
  769.  
  770. If there is no movie currently playing, then when you drop an MPEG movie it 
  771. will be automatically loaded and start playing. 
  772.  
  773. If there is a movie currently playing, then that movie will stop and the new 
  774. movie will be automatically loaded and start playing. 
  775.  
  776. If there is a movie currently playing, and you attempt to drop a non-MPEG movie 
  777. then the movie will stop playing. You then have to click on the Play button to 
  778. continue playing the current movie. 
  779.  
  780.  
  781. ΓòÉΓòÉΓòÉ 10. Menus ΓòÉΓòÉΓòÉ
  782.  
  783. The following sections describe the menus available in PMMPEG. 
  784.  
  785.      File Menu 
  786.  
  787.         -  Open... 
  788.  
  789.         -  Save... 
  790.  
  791.         -  Register... 
  792.  
  793.      Movie Menu 
  794.  
  795.         -  Half Size 
  796.  
  797.         -  Normal Size 
  798.  
  799.         -  Double Size 
  800.  
  801.         -  Unlimited 
  802.  
  803.         -  Fast 
  804.  
  805.         -  Medium 
  806.  
  807.         -  Slow 
  808.  
  809.      Options Menu 
  810.  
  811.         -  Show Menu/Toolbar 
  812.  
  813.         -  Show Status Bar 
  814.  
  815.         -  Note Decoding Errors 
  816.  
  817.         -  Maintain Aspect Ratio 
  818.  
  819.         -  Use DIVE - <n> Colors 
  820.  
  821.         -  DIVE Details Dialog 
  822.  
  823.         -  Help 
  824.  
  825.  
  826. ΓòÉΓòÉΓòÉ 11. File ΓòÉΓòÉΓòÉ
  827.  
  828. Use File to open or save an MPEG movie and to register your use of PMMPEG. 
  829.  
  830.  
  831. ΓòÉΓòÉΓòÉ 11.1. Open ΓòÉΓòÉΓòÉ
  832.  
  833. Use Open to display a window that enables you to choose one or more MPEG 
  834. movies. 
  835.  
  836. You can also drag and drop one or more movies from a folder onto the PMMPEG 
  837. window. 
  838.  
  839.  
  840. ΓòÉΓòÉΓòÉ 11.2. Save ΓòÉΓòÉΓòÉ
  841.  
  842. Use Save to display a dialog box that enables you to save the MPEG file 
  843. currently loaded.  This is especially useful for WebExplorer users as 
  844. WebExplorer generates a non-intuitive filename and writes the file to the 
  845. directory pointed to by your TMP environment variable.  This menu item will 
  846. only be enabled when a movie is loaded. 
  847.  
  848.  
  849. ΓòÉΓòÉΓòÉ 11.3. Register ΓòÉΓòÉΓòÉ
  850.  
  851. Use Register to display a dialog box that enables you to register your payment 
  852. of the shareware fee for PMMPEG. When I send you the registration key after you 
  853. send me the fee, enter your name, organization and the EXACT registration key, 
  854. then click OK.  The key is checked and if acceptable, the pop-up warning 
  855. displayed each time PMMPEG is launched will stop.  When you then select the 
  856. Product Information item from the Help menu, your name and organization will be 
  857. displayed. 
  858.  
  859. Please see the Registration section to see how to register your copy of PMMPEG. 
  860.  
  861.  
  862. ΓòÉΓòÉΓòÉ 12. Movie ΓòÉΓòÉΓòÉ
  863.  
  864. Use Movie to set the size and to limit the playback speed of the movie. 
  865.  
  866.  
  867. ΓòÉΓòÉΓòÉ 12.1. Half Size ΓòÉΓòÉΓòÉ
  868.  
  869. Use Half Size to shrink down the size of the playback window to half the size 
  870. encoded in the movie file.  This can speed up playback a little due to the fact 
  871. that fewer pixels have to be changed on the screen. 
  872.  
  873. Note that Presentation Manager has some rules about minimum frame window size, 
  874. so you may not be able to get true half size playback for movies that are 
  875. encoded with a small size. 
  876.  
  877.  
  878. ΓòÉΓòÉΓòÉ 12.2. Normal Size ΓòÉΓòÉΓòÉ
  879.  
  880. Use Normal Size to set the size of the playback window to exactly the size 
  881. encoded in the movie file. 
  882.  
  883.  
  884. ΓòÉΓòÉΓòÉ 12.3. Double Size ΓòÉΓòÉΓòÉ
  885.  
  886. Use Double Size to set the size of the playback window to exactly double the 
  887. size encoded in the movie file. This slows down playback a bit because 4X the 
  888. number of pixels have to be changed on the screen.  DIVE mode helps a lot here 
  889. because it's been tuned to scale the playback size better than the conventional 
  890. GpiBitBlt method. 
  891.  
  892.  
  893. ΓòÉΓòÉΓòÉ 12.4. Unlimited ΓòÉΓòÉΓòÉ
  894.  
  895. Set movie playback speed to go as fast as it possibly can. The playback speed 
  896. is directly related to the speed of the processor in your machine, how much 
  897. cache you have, how fast your hard disk and controller are, how fast your 
  898. graphics card is and how it's connected to your system. 
  899.  
  900. PMMPEG does not have any exact frame rate settings due to the lack of a 
  901. high-speed timer and the complexity of MPEG decoding. 
  902.  
  903.  
  904. ΓòÉΓòÉΓòÉ 12.5. Fast ΓòÉΓòÉΓòÉ
  905.  
  906. Set movie playback speed to play at a maximum of approximately 30 frames per 
  907. second on machines that can play that fast. There are a number of factors that 
  908. can affect the actual playback speed so this is just a guideline. This is 
  909. useful for fast computers that play movies far too fast. 
  910.  
  911. PMMPEG does not have any exact frame rate settings due to the lack of a 
  912. high-speed timer and the complexity of MPEG decoding. 
  913.  
  914.  
  915. ΓòÉΓòÉΓòÉ 12.6. Medium ΓòÉΓòÉΓòÉ
  916.  
  917. Set movie playback speed to play at a maximum of approximately 15 frames per 
  918. second on machines that can play that fast. There are a number of factors that 
  919. can affect the actual playback speed so this is just a guideline. This is 
  920. useful for fast computers that play movies far too fast. 
  921.  
  922. PMMPEG does not have any exact frame rate settings due to the lack of a 
  923. high-speed timer and the complexity of MPEG decoding. 
  924.  
  925.  
  926. ΓòÉΓòÉΓòÉ 12.7. Slow ΓòÉΓòÉΓòÉ
  927.  
  928. Set movie playback speed to play at a maximum of approximately 5 frames per 
  929. second on machines that can play that fast. There are a number of factors that 
  930. can affect the actual playback speed so this is just a guideline. This is 
  931. useful for fast computers that play movies far too fast or when you want a 
  932. "slow motion" playback. 
  933.  
  934. PMMPEG does not have any exact frame rate settings due to the lack of a 
  935. high-speed timer and the complexity of MPEG decoding. 
  936.  
  937.  
  938. ΓòÉΓòÉΓòÉ 13. Options ΓòÉΓòÉΓòÉ
  939.  
  940. Use Options to toggle menus, status bars and turn the DIVE support on and off. 
  941.  
  942.  
  943. ΓòÉΓòÉΓòÉ 14. WebExplorer ΓòÉΓòÉΓòÉ
  944.  
  945. WebExplorer is an application that ships with OS/2 Warp that allows users to 
  946. browse WorldWideWeb sites all over the world with a few easy clicks. 
  947. WebExplorer can be configured to launch various programs when it encounters 
  948. various types of data on these Web sites. 
  949.  
  950. One of these types of data is MPEG files, generally found with the .MPG 
  951. extension.  To configure WebExplorer to automatically launch PMMPEG whenever 
  952. you select an MPEG file, do the following: 
  953.  
  954.      Start WebExplorer by double-clicking on its icon in the IBM Internet 
  955.       Connection for OS/2 folder. 
  956.  
  957.      Click on the Configure menu item 
  958.  
  959.      Click on the Viewers... menu item. 
  960.  
  961.      Click on the button in the ComboBox and scroll down the list until you 
  962.       find MPEG video format. 
  963.  
  964.      Enter the full path to PMMPEG.EXE in the Program field.  You must specify 
  965.       the driver letter and complete path, i.e. E:\TCPIP\BIN\PMMPEG.EXE 
  966.  
  967.      Click on the OK button 
  968.  
  969.  Now start up your connection to the Internet and browse one of the well-known 
  970.  MPEG sites. When you click on an .MPG filename, it should load the file, 
  971.  launch PMMPEG and automatically start playing the movie. 
  972.  
  973.  
  974. ΓòÉΓòÉΓòÉ 14.1. Show Menu/Toolbar ΓòÉΓòÉΓòÉ
  975.  
  976. Toggle the display/no display of the menu bar and the toolbar. This is useful 
  977. to set up a very plain playback frame by removing the menu bar and the toolbar. 
  978. You can still control the player using the pop-up menu using Mouse Button 2. 
  979.  
  980.  
  981. ΓòÉΓòÉΓòÉ 14.2. Status ΓòÉΓòÉΓòÉ
  982.  
  983. Use Status to enable the Status bar at the bottom of the frame window.  This 
  984. will display the size in pixels, the frame type of the movie, and the running 
  985. frames/second value.  Click on the Status menu item again to remove the Status 
  986. bar.  The window will resize itself to accommodate the size of the status bar. 
  987.  
  988. The status bar will display an 'I' for MPEG movies with I-frames only: and 
  989. 'IBP' for MPEG movies with IBP-frames: 
  990.  
  991. The status bar can optionally display an indication of frames with some kind of 
  992. decoding problem 
  993.  
  994.  
  995. ΓòÉΓòÉΓòÉ 14.3. Note Decoding Errors ΓòÉΓòÉΓòÉ
  996.  
  997. Use Note Decoding Errors to enable the Status bar at the bottom of the frame 
  998. window to show which frames of the movie have some kind of decoding problem 
  999.  
  1000. Each frame that has a decoding error will cause the Status bar to have a red 
  1001. background, which changes back to a gray background on the next correct frame. 
  1002. Click on the Note Decoding Errors menu item again to remove this feature. 
  1003.  
  1004.  
  1005. ΓòÉΓòÉΓòÉ 14.4. Maintain Aspect Ratio ΓòÉΓòÉΓòÉ
  1006.  
  1007. Use Maintain Aspect Ratio to make sure the playback window sets itself to be in 
  1008. the proper ratio to the original movie when you resize the window by dragging 
  1009. one of the window edges larger or smaller. 
  1010.  
  1011. This makes movies "look right" by preventing playback from being too tall or 
  1012. too wide.  Click on the Maintain Aspect Ratio menu item again to gain complete 
  1013. control over the playback window. 
  1014.  
  1015.  
  1016. ΓòÉΓòÉΓòÉ 14.5. Use DIVE - <n> Colors ΓòÉΓòÉΓòÉ
  1017.  
  1018. Use Use DIVE - <n> Colors to enable the high speed DIVE graphics system. 
  1019.  
  1020. This menu item will only be available if the DIVE subsystem is enabled on your 
  1021. system.  If enabled, the <n> will be replaced with the number of colors your 
  1022. desktop is currently set to.  This will generally be 256, 64K or 16M for 256 
  1023. colors, 65,536 colors or 16.7 million colors.  Depending on the graphics 
  1024. adapter, amount of video RAM and graphics driver you have, you can change the 
  1025. number of colors on your desktop using Page 1 of the System notebook in the 
  1026. System Setup folder. 
  1027.  
  1028. Increasing the number of colors will generally give you a better image, but 
  1029. will slow down the playback speed due to the increase in the amount of data to 
  1030. be changed in your video RAM. 
  1031.  
  1032. Click on the Use DIVE - <n> Colors item again to go back to the conventional 
  1033. GpiBitBlit display method. 
  1034.  
  1035.  
  1036. ΓòÉΓòÉΓòÉ 14.6. DIVE Details Dialog ΓòÉΓòÉΓòÉ
  1037.  
  1038. Use DIVE Details to query the DIVE graphics system. capabilites of your system. 
  1039.  
  1040. This menu item will only be available if the DIVE subsystem is enabled on your 
  1041. system.  If enabled, a dialog box will pop up with all of the gory details 
  1042. about how DIVE is running on your system.  Here are some of the more 
  1043. interesting details: 
  1044.  
  1045.      Direct screen access.  This will always be YES. 
  1046.  
  1047.      Screen access requires bank switch.  If NO, DIVE can write directly to 
  1048.       anywhere in your video RAM.  If YES, it must access your video RAM in a 
  1049.       segmented manner, slowing performance. 
  1050.  
  1051.      Screen color depth.  This is the number of bits of color for each pixel. 
  1052.       8 = 256 colors, 16 = 64K colors, 24 = 16.7 million colors. 
  1053.  
  1054.      Screen aperture size.  This is the amount of video RAM accessible at any 
  1055.       one time. 
  1056.  
  1057.      Number of input formats.  This is the number of different color spaces 
  1058.       that DIVE can directly handle. 
  1059.  
  1060.      Number of output formats.  This is the number of different color spaces 
  1061.       that DIVE can directly handle. 
  1062.  
  1063.  
  1064. ΓòÉΓòÉΓòÉ 15. Open ΓòÉΓòÉΓòÉ
  1065.  
  1066. Use Open to select one or more MPEG movies: 
  1067.  
  1068.    1. Select the down arrow to the right of the Drive list to display all the 
  1069.       drives on your system. 
  1070.    2. Select a drive from the Drive list. 
  1071.    3. Select a directory from the Directory list. 
  1072.    4. Select one or more file names from the File list or type in a filename. 
  1073.    5. Select the Open pushbutton to play the movies you want to view. 
  1074.  
  1075.  For a detailed explanation of each field, select from the list below: 
  1076.  
  1077.      Open file name 
  1078.      Type of file 
  1079.      Drive 
  1080.      File 
  1081.      Directory 
  1082.      Open 
  1083.      Cancel 
  1084.  
  1085.  
  1086. ΓòÉΓòÉΓòÉ 16. Keys PMMPEG ΓòÉΓòÉΓòÉ
  1087.  
  1088. There is no key specific PMMPEG help. 
  1089.  
  1090.  
  1091. ΓòÉΓòÉΓòÉ 17. Open Filename ΓòÉΓòÉΓòÉ
  1092.  
  1093. Type the name of the movie you want to open in the Open filename field.  If you 
  1094. include a wildcard character such as * or ?, the file list will be restricted 
  1095. to those filenames that match the pattern.  Click on one or more filenames in 
  1096. the list and select the Open pushbutton. 
  1097.  
  1098.  
  1099. ΓòÉΓòÉΓòÉ 18. Type of File ΓòÉΓòÉΓòÉ
  1100.  
  1101. Select the down arrow to the right of the Type of file field to display the 
  1102. available file types. 
  1103.  
  1104.  
  1105. ΓòÉΓòÉΓòÉ 19. Drive ΓòÉΓòÉΓòÉ
  1106.  
  1107. The Drive list displays the drives on your system.  Select the drive that 
  1108. contains the files you want to view. 
  1109.  
  1110.  
  1111. ΓòÉΓòÉΓòÉ 20. File ΓòÉΓòÉΓòÉ
  1112.  
  1113. The File list displays all the files that match the current pattern in the Open 
  1114. Filename field.  Select one or more files you want to open by clicking with the 
  1115. mouse.  Clicking on a selected filename will remove it from the list of 
  1116. selected files. 
  1117.  
  1118.  
  1119. ΓòÉΓòÉΓòÉ 21. Directory ΓòÉΓòÉΓòÉ
  1120.  
  1121. The Directory list displays the directories on the selected drive.  Select a 
  1122. directory to display the list of files from that directory in the File list 
  1123. box. 
  1124.  
  1125.  
  1126. ΓòÉΓòÉΓòÉ 22. OK ΓòÉΓòÉΓòÉ
  1127.  
  1128. Select OK to accept all information in the window, remove the window from the 
  1129. screen and view the movie. 
  1130.  
  1131.  
  1132. ΓòÉΓòÉΓòÉ 23. Cancel ΓòÉΓòÉΓòÉ
  1133.  
  1134. Select Cancel to remove the window from the screen without viewing a movie. 
  1135.  
  1136.  
  1137. ΓòÉΓòÉΓòÉ 24. PMMPEG ΓòÉΓòÉΓòÉ
  1138.  
  1139. Use PMMPEG to display digital movies conforming to the MPEG-1 specification. 
  1140. PMMPEG can handle both I-Frame only movies and IBP-Frame movies.  It cannot 
  1141. currently handle MPEG movies with embedded sounds, MPEG 1 Stream files or 
  1142. MPEG-2 files. 
  1143.  
  1144. Related Information: 
  1145.  
  1146.      Command Line Options 
  1147.      Installation 
  1148.      Desktop Object 
  1149.      MPEG File Association 
  1150.      Toolbar 
  1151.      Menus 
  1152.      Status Bar 
  1153.      Slideshow 
  1154.      Saving Individual Frames 
  1155.      Drag/Drop 
  1156.      256 Colors 
  1157.      Summary of New Features 
  1158.      Suggestions for Future Releases 
  1159.      MPEG File Info 
  1160.      MPEG-2 Info 
  1161.      DIVE 
  1162.      WebExplorer 
  1163.      Origin of the Code 
  1164.      Movie Sites 
  1165.      Known Bugs 
  1166.      Credits 
  1167.      Author Contact 
  1168.      Registration 
  1169.  
  1170.  
  1171. ΓòÉΓòÉΓòÉ 25. Help ΓòÉΓòÉΓòÉ
  1172.  
  1173. Use Help to display the Help submenu with the following menu items: 
  1174.  
  1175.      Help Index 
  1176.  
  1177.      General Help 
  1178.  
  1179.      Using Help 
  1180.  
  1181.      Product Information 
  1182.  
  1183.  
  1184. ΓòÉΓòÉΓòÉ 26. Help Index ΓòÉΓòÉΓòÉ
  1185.  
  1186. Use Help Index to display the index of all items in the on-line help system. 
  1187.  
  1188.  
  1189. ΓòÉΓòÉΓòÉ 27. General Help ΓòÉΓòÉΓòÉ
  1190.  
  1191. Use General Help to display the high-level help items in the on-line help 
  1192. system. 
  1193.  
  1194.  
  1195. ΓòÉΓòÉΓòÉ 28. Using Help ΓòÉΓòÉΓòÉ
  1196.  
  1197. Use Using Help to display the help items on how to use the on-line help system 
  1198. built into OS/2. 
  1199.  
  1200.  
  1201. ΓòÉΓòÉΓòÉ 29. Product Information ΓòÉΓòÉΓòÉ
  1202.  
  1203. Use Product Information to display the "About Box" for PMMPEG. 
  1204.  
  1205. If you haven't registered your copy of PMMPEG, you will be gently reminded to 
  1206. send in your registration and how many days left you have in your 30 day 
  1207. evaluation period.  If you have more than 15 days left, the text will be 
  1208. displayed normally.  If you have less than 15 days left the text will be 
  1209. displayed in yellow.  If you go over your evaluation period, the text will turn 
  1210. to red, but the application will continue to work, with no loss of function. 
  1211.  
  1212. If you have registered, your name and organization will be displayed in the 
  1213. text, thanking you for your registration. 
  1214.  
  1215.  
  1216. ΓòÉΓòÉΓòÉ 30. MPEG File Info ΓòÉΓòÉΓòÉ
  1217.  
  1218. This program implements the standard described in the Committee Draft ISO/IEC 
  1219. CD 11172 dated December 6, 1991 which is sometimes refered to as "Paris 
  1220. Format." 
  1221.  
  1222. The player expects MPEG-1 video streams only. It can not handle multiplexed 
  1223. MPEG streams or video+audio streams. The player uses the paris entropy coding 
  1224. table set (which we believe to be the MPEG-1 standard), but can not handle any 
  1225. bitstreams that use the "berlin" entropy coding table set. Berlin data is 
  1226. relatively rare so there shouldn't be too much to worry about here, but be 
  1227. aware of the difference when looking for streams to play. 
  1228.  
  1229. XING is a popular DOS/Windows-based MPEG encoder/player that does not take 
  1230. advantage of P or B frames (ie, frames with motion compensation). Performance 
  1231. of the player on XING data is significantly slower (half or less) than the 
  1232. performance when motion compensated MPEG data is decoded. 
  1233.  
  1234.  
  1235. ΓòÉΓòÉΓòÉ 31. MPEG-2 Info ΓòÉΓòÉΓòÉ
  1236.  
  1237. There is a new version of MPEG on the block, MPEG-2, otherwise known as ISO/IEC 
  1238. DIS 13818-2.  I have experimented with the sample MPEG-2 decoder and found that 
  1239. the visual quality is lacking on MPEG-1 movies that work well with the Berkeley 
  1240. decoding engine.  Moving up to an MPEG-2 decoding engine will allow more movies 
  1241. to be played, but at the expense of a clear image on the movies we all know and 
  1242. love.  As most movies are still MPEG-1 at this time, I have decided to stick 
  1243. with the Berkeley engine and revisit the MPEG-2 engine at a future date. 
  1244.  
  1245. Here is some information on MPEG-2 from the README file of the MPEG-2 source 
  1246. code package for an encoder and decoder from the MPEG Software Simulation 
  1247. Group.  The code can be obtained from ftp.netcom.com in the /pub/cfogg/mpeg2 
  1248. directory. They maintain a listserver for their code.  Email to 
  1249. listserv@netcom.com with message text: subscribe mpeg-users  [your E-mail 
  1250. address] 
  1251.  
  1252. MPEG-2 Video is a generic method for compressed representation of video 
  1253. sequences using a common coding syntax defined in the document ISO/IEC 13818 
  1254. Part 2 (CD: Nov. 1993, DIS: March 1994) by the International Organization for 
  1255. Standardization (ISO) and the International Electrotechnical Commission (IEC), 
  1256. in collaboration with the International Telecommunications Union (ITU) as 
  1257. Recommendation H.262. The MPEG-2 concept is similar to MPEG-1, but includes 
  1258. extensions to cover a wider range of applications. 
  1259.  
  1260. The primary application targeted during the MPEG-2 definition process was the 
  1261. all-digital transmission of broadcast TV quality video at coded bitrates 
  1262. between 4 and 9 Mbit/sec.  However, the MPEG-2 syntax has been found to be 
  1263. efficient for other applications such as those at higher bit rates and sample 
  1264. rates (e.g. HDTV). The most significant enhancement over MPEG-1 is the addition 
  1265. of syntax for efficient coding of interlaced video (e.g. 16x8 block size motion 
  1266. compensation, Dual Prime, et al).  Several other more subtle enhancements (e.g. 
  1267. 10-bit DCT DC precision, non-linear quantization, VLC tables, improved mismatch 
  1268. control) are included which have a noticeable improvement on coding efficiency, 
  1269. even for progressive video. 
  1270.  
  1271. Other key features of MPEG-2 are the scalable extensions which permit the 
  1272. division of a continuous video signal into two or more coded bit streams 
  1273. representing the video at different resolutions, picture quality (i.e. SNR), or 
  1274. picture rates. 
  1275.  
  1276.  
  1277. ΓòÉΓòÉΓòÉ 32. DIVE ΓòÉΓòÉΓòÉ
  1278.  
  1279. All display drivers in the OS/2 Warp 3.0 box and a growing number of 3rd party 
  1280. graphics card drivers (running with at least 256 colors) allow for a technique 
  1281. called DIVE, or Direct Interface Video Extensions.  It's easy for a 3rd party 
  1282. driver writer to include DIVE support because the support code is in the 
  1283. reference video driver shipped in the Device Driver Kit shipped by IBM. 
  1284.  
  1285. DIVE consists of a set of APIs that allows application developers to get 
  1286. higher-speed graphics output than the conventional GpiBitBlt approach and also 
  1287. provides color conversion facilities. 
  1288.  
  1289. DIVE has evolved over time. 
  1290.  
  1291.      In OS/2 2.0, it was a private interface used by the Ultimotion movie 
  1292.       display application. 
  1293.  
  1294.      In OS/2 2.1, a single IOCtl interface was documented to provide raw video 
  1295.       RAM access from a conventional Ring 3 OS/2 Presentation Manager 
  1296.       application.  There were some problems implementing this interface in 
  1297.       PMMPEG 2.1.  I chose to not implement DIVE at that time: 
  1298.  
  1299.         -  DIVE forces you to write the color index of the palette currently 
  1300.            loaded in the hardware.  I got this working for grayscale but in 
  1301.            color mode the colors were way off and I couldn't figure out why.  I 
  1302.            believe the Berkeley engine is having a hard time dithering to the 
  1303.            table of color indexes I set up, but since this doesn't work it's a 
  1304.            major reason not to include it. 
  1305.  
  1306.         -  DIVE does not handle expansion of an image so I would have to double 
  1307.            the image by hand in my code, or lose that feature. 
  1308.  
  1309.         -  Due to the length of time it takes to decode and dither each frame 
  1310.            in the movie as compared to the short amount of time it takes to 
  1311.            actually get PM to display the frame, I was only seeing 0.5 to 1 
  1312.            frame per second improvement. I need to make serious increases in 
  1313.            decoding and dithering performance before DIVE will make a serious 
  1314.            difference in the overall frame rate. 
  1315.  
  1316.         -  DIVE completely writes over whatever is on the screen at that place. 
  1317.            This is a problem when you try to pull down the Options menu - DIVE 
  1318.            overwrites the menu with the frames as they're decoded and you can't 
  1319.            tell what you're selecting from the menu. 
  1320.  
  1321.         -  You have to have a graphics device driver that has been written to 
  1322.            tolerate DIVE and you have to have the SMVDD.SYS driver from MMPM/2 
  1323.            in your CONFIG.SYS for DIVE from an application to work.  Most newer 
  1324.            drivers will work, but some may not. 
  1325.  
  1326.      OS/2 Warp 3.0 has documented a set of powerful APIs that provide 
  1327.       high-speed graphics display (including image stretch and compress), 
  1328.       clipping rectangle handling and color space conversion, built into every 
  1329.       video driver that ships with OS/2 Warp 3.0 and running with at least 256 
  1330.       colors. If the desktop is currently set to 16 colors, DIVE will not be 
  1331.       enabled because 16 colors is insufficient to generate decent images. 
  1332.       Color space conversion means that DIVE will take care of converting 
  1333.       images using non-RGB color descriptions.  This is especially useful for 
  1334.       PMMPEG because the MPEG files contain the color data in YUV422 color 
  1335.       space and DIVE knows how to convert these colors at high speed to the RGB 
  1336.       values required by most graphics cards. 
  1337.  
  1338.       There is an overview of DIVE in the Multimedia Application Programming 
  1339.       Guide and the APIs are documented in the Multimedia Programming 
  1340.       Reference. These books come on-line in the OS/2 Warp 3.0 toolkit.  It is 
  1341.       currently (April 1995) available only via the Developer Connection CD-ROM 
  1342.       subscription service. I expect it will be bundled with various compilers 
  1343.       as compiler vendors ship new versions.  To use DIVE in your application 
  1344.       you only need to #include <dive.h> and <fourcc.h> in your application and 
  1345.       call the Dive* APIs you require.  DIVE.DLL will be dynamically loaded by 
  1346.       OS/2 when your application runs. 
  1347.  
  1348.       The high-level APIs available in DIVE are: 
  1349.  
  1350.         -  DiveOpen - Opens a DIVE instance for your application 
  1351.  
  1352.         -  DiveClose - Closes the DIVE instance 
  1353.  
  1354.         -  DiveQueryCaps - Query DIVE capabilities for current system 
  1355.  
  1356.         -  DiveAllocImageBuffer - Allocate buffer, perhaps right in Video RAM 
  1357.  
  1358.         -  DiveFreeImageBuffer - Free the buffer 
  1359.  
  1360.         -  DiveSetupBlitter - Describe image color space, areas to paint on 
  1361.            Blit 
  1362.  
  1363.         -  DiveBeginImageBufferAccess - Gain addressability to the buffer 
  1364.  
  1365.         -  DiveEndImageBufferAccess - Release addressability to the buffer 
  1366.  
  1367.         -  DiveBlitImage - Convert color space and put image on the screen 
  1368.  
  1369.         -  DiveSetDestinationPalette - tell DIVE when hardware palette changes 
  1370.  
  1371.       The low-level features available in DIVE are: 
  1372.  
  1373.         -  DiveCalcFrameBufferAddress - get Ring 3 address in video RAM 
  1374.  
  1375.         -  DiveAcquireFrameBuffer - get access to raw video RAM 
  1376.  
  1377.         -  DiveDeacquireFrameBuffer - release access to raw video RAM 
  1378.  
  1379.         -  DiveSwitchBank - required for multiple aperture video subsystem 
  1380.  
  1381.  There is another component, called enDIVE, that works at the graphics driver 
  1382.  layer.  It allows a programmer developing a graphics driver for a card with 
  1383.  special hardware support to be able to take advantage of all of the features 
  1384.  the hardware can offer in a standard way.  Chips are coming on the market that 
  1385.  can do color space conversions, stretching and compressing images, etc.  This 
  1386.  is clearly going to be faster than doing it in software, giving any 
  1387.  DIVE-enabled application a large, transparent speed increase.  If your 
  1388.  graphics card has such support, please email to me so I can see the 
  1389.  performance that new hardware and enDIVE provides.  I'm told that the ThinkPad 
  1390.  755 has a chip (ASKEY?) that performs some of this, as does an upcoming Weitek 
  1391.  chip. 
  1392.  
  1393.  If you're curious about DIVE, I'm going to be giving a session on DIVE in 
  1394.  general and specifically my experience implementing it in PMMPEG at the Fourth 
  1395.  Annual ColoradOS/2 developer's conference.  It will be held October 16 - 20, 
  1396.  1995 at the Keystone Resort in Vail, Colorado.  For a brochure and reservation 
  1397.  information, please call Wayne Kovsky at (719)481-3389. 
  1398.  
  1399.  
  1400. ΓòÉΓòÉΓòÉ 33. Origin of the Code ΓòÉΓòÉΓòÉ
  1401.  
  1402.      Computer Science Division-EECS, Univ. of Calif. at Berkeley. Lawrence A. 
  1403.       Rowe, Ketan Patel, and Brian Smith wrote a Unix and X Windows-based MPEG 
  1404.       decoder and viewer.  This program is based on their version 2.0 release. 
  1405.  
  1406.       To get the original source, ftp to toe.cs.berkeley.edu, directory 
  1407.       /pub/multimedia/mpeg/mpeg-2.0.tar.Z. 
  1408.  
  1409.       These folks have set up several mailing lists for their code. 
  1410.  
  1411.         -  mpeg-list-dist@CS.Berkeley.EDU 
  1412.  
  1413.            General information on the decoder for everyone interested   should 
  1414.            be sent to this list.  This should become active after   11/20/92 
  1415.  
  1416.         -  mpeg-list-request@CS.Berkeley.EDU 
  1417.  
  1418.            Requests to join or leave the list should be sent to this   address. 
  1419.            The subject line should contain the single word   ADD or DELETE. 
  1420.  
  1421.         -  mpeg-bugs@CS.Berkeley.EDU 
  1422.  
  1423.            Problems, questions, or patches should be sent to this address. 
  1424.  
  1425.      Tom Lane of the Independent JPEG Group provided the basic inverse DCT 
  1426.       code used by the Berkeley player. (tom_lane@g.gp.cs.cmu.edu) 
  1427.  
  1428.      John Webb contributed the frame subclass code for the status bar and 
  1429.       provided invaluable help when things wouldn't work right. 
  1430.  
  1431.      I, Mike Brown, ported the Unix/X code to OS/2 and Presenation Manager and 
  1432.       "integerized" the heavy floating point in the inverse DCT routine. 
  1433.  
  1434.  Click to see the Berkley Disclaimer 
  1435.  
  1436.  
  1437. ΓòÉΓòÉΓòÉ 34. Berkeley Disclaimer ΓòÉΓòÉΓòÉ
  1438.  
  1439. /*
  1440.  * Copyright (c) 1992 The Regents of the University of California.
  1441.  * All rights reserved.
  1442.  *
  1443.  * Permission to use, copy, modify, and distribute this software and its
  1444.  * documentation for any purpose, without fee, and without written agreement is
  1445.  * hereby granted, provided that the above copyright notice and the following
  1446.  * two paragraphs appear in all copies of this software.
  1447.  *
  1448.  * IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR
  1449.  * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
  1450.  * OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF
  1451.  * CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  1452.  *
  1453.  * THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
  1454.  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
  1455.  * AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
  1456.  * ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATION TO
  1457.  * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  1458.  */
  1459.  
  1460.  
  1461. ΓòÉΓòÉΓòÉ 35. Movie Sites ΓòÉΓòÉΓòÉ
  1462.  
  1463. You can get MPEG movies from computers around the world.  The well-known ones I 
  1464. have found are: 
  1465.  
  1466.            ftp Sites
  1467.  
  1468.                    -  emx.cc.utexas.edu         /pub/mnt/mpeg
  1469.  
  1470.                    -  s2k-ftp.cs.berkeley.edu   /pub/multimedia/mpeg/movies
  1471.  
  1472.                    -  havefun.stanford.edu      /pub/mpeg
  1473.  
  1474.                    -  phoenix.oulu.fi           /pub/mpeg
  1475.  
  1476.                    -  calypso-2.oit.unc.edu     /pub/multimedia/animation/mpeg
  1477.  
  1478.                    -  seds.lpl.arizona.edu      /pub/anim
  1479.  
  1480.                    -  venice.tcp.com            /pub/anime-manga/anim/mpeg
  1481.  
  1482.                    -  ftp.hawaii.edu
  1483.  
  1484.                    -  ftp.univ-rennes1.fr       /pub/Images/Astro
  1485.  
  1486.                    -  ftp.netcom.com            /pub/jrp/film.html
  1487.  
  1488.  
  1489.            World Wide Web Pages:
  1490.  
  1491.                    -  www.univ-rennes1.fr/Astro/anime-e.html
  1492.  
  1493.                    -  mambo.ucsc.edu/psl/thant/thant.html
  1494.  
  1495.                    -  akebono.stanford.edu/yahoo/Computers/Multimedia/Movies
  1496.  
  1497.                    -  match.com/~tlod
  1498.  
  1499.  
  1500.            Internet Newsgroups
  1501.  
  1502.                    -  alt.binaries.multimedia
  1503.  
  1504.  
  1505. ΓòÉΓòÉΓòÉ 36. Known Bugs ΓòÉΓòÉΓòÉ
  1506.  
  1507. These bugs are known and are on the list of things to fix in the next release. 
  1508.  
  1509.      DIVE black frame handling broken 
  1510.  
  1511.      DIVE resized or uncovered no image displayed 
  1512.  
  1513.      Crashes loading certain movies 
  1514.  
  1515.      Frames flip back and forth quickly 
  1516.  
  1517.      Diagonal stripes playback 
  1518.  
  1519.      Crashes playing certain movies 
  1520.  
  1521.      Color Table 
  1522.  
  1523.      Bad Encodings 
  1524.  
  1525.      Playback Speed 
  1526.  
  1527.      OS/2 for SMP 
  1528.  
  1529.      Icon Problem 
  1530.  
  1531.      Many PMMPEG.INI files, options not saved 
  1532.  
  1533.  
  1534. ΓòÉΓòÉΓòÉ 36.1. Color Table Problem ΓòÉΓòÉΓòÉ
  1535.  
  1536. When switching from color to gray or gray to color while an I-Frame-only movie 
  1537. is playing, you will see a 1 frame distortion of colors. This is a restriction 
  1538. on the way the color table is handled and the proper display of the image will 
  1539. pick up after the color table change completely makes its way through the 
  1540. application.  On IBP-Frame movies, it can take a few frames for the image to 
  1541. correct itself, generally until an I frame is encountered. 
  1542.  
  1543.  
  1544. ΓòÉΓòÉΓòÉ 36.2. DIVE black frame handling broken ΓòÉΓòÉΓòÉ
  1545.  
  1546. The first few initial black frames of MPEG files are not correctly detected and 
  1547. ignored in DIVE mode.  Just ignore them... 
  1548.  
  1549.  
  1550. ΓòÉΓòÉΓòÉ 36.3. DIVE resized or uncovered no image displayed ΓòÉΓòÉΓòÉ
  1551.  
  1552. When the window is resized or part of the window is uncovered while in DIVE 
  1553. mode and the movie is stopped, the image is not displayed.  This is because the 
  1554. image is generated, handed to the DIVE system and tossed away, so there's 
  1555. nothing to hand to DIVE again. 
  1556.  
  1557.  
  1558. ΓòÉΓòÉΓòÉ 36.4. Crashes loading certain movies ΓòÉΓòÉΓòÉ
  1559.  
  1560. PMMPEG will crash loading certain movies, such as one featuring a jet. 
  1561.  
  1562.  
  1563. ΓòÉΓòÉΓòÉ 36.5. Frames flip back and forth quickly ΓòÉΓòÉΓòÉ
  1564.  
  1565. PMMPEG will play certain movies normally and then get stuck on two frames, 
  1566. flipping back and forth between them quickly.  pamander.mpg, christie.mpg and 
  1567. ss-94.mpg exhibit this behavior. 
  1568.  
  1569.  
  1570. ΓòÉΓòÉΓòÉ 36.6. Diagonal stripes playback ΓòÉΓòÉΓòÉ
  1571.  
  1572. PMMPEG will play certain movies badly, showing only diagonal stripes of color. 
  1573. These movies always have sizes that aren't exact multiples of 16 pixels.  This 
  1574. points to a bug in the underlying Berkeley decoder engine.  Thanks to Murray 
  1575. Penny for the Web site http://rs560.cl.msu.edu/weather for examples of bad 
  1576. playback. 
  1577.  
  1578.  
  1579. ΓòÉΓòÉΓòÉ 36.7. Crashes playing certain movies ΓòÉΓòÉΓòÉ
  1580.  
  1581. PMMPEG will crash playing certain movies, such as disposal.mpg 
  1582.  
  1583.  
  1584. ΓòÉΓòÉΓòÉ 36.8. Bad Encodings ΓòÉΓòÉΓòÉ
  1585.  
  1586. Some movies have encoding problems.  PMMPEG tries to handle these as best as 
  1587. possible (for example skipping corrupted frames) and continue playing the 
  1588. movie.  There are a few distinct cases that will cause the following behaviours 
  1589. in PMMPEG: 
  1590.  
  1591.      PMMPEG may crash either at the initial load of the movie or at some point 
  1592.       during playback. 
  1593.  
  1594.      Two movies I have found will get to a certain point in the movie and then 
  1595.       rapidly flip back and forth between two adjacent frames and never 
  1596.       terminate. 
  1597.  
  1598.      Two movies I have found seem to have a problem with the "vertical hold" 
  1599.       as the display looks like a series of jagged diagonal lines. 
  1600.  
  1601.  I will work to bulletproof the code, but it also depends on the Berkeley folks 
  1602.  to release bug fixes to their engine that will help all platforms. 
  1603.  
  1604.  
  1605. ΓòÉΓòÉΓòÉ 36.9. Playback Speed ΓòÉΓòÉΓòÉ
  1606.  
  1607. Movie playback is not real-time, except on high-performance systems. Faster CPU 
  1608. and video cards will help to improve the situation and internal optimization is 
  1609. ongoing.  Use grayscale to get the fastest playback, at the expense of losing 
  1610. color. 
  1611.  
  1612.  
  1613. ΓòÉΓòÉΓòÉ 36.10. OS/2 for SMP ΓòÉΓòÉΓòÉ
  1614.  
  1615. PMMPEG seems to work well on a beta level of OS/2 for SMP, the version of OS/2 
  1616. that can run on certain machines that have multiple 486 or Pentium processors. 
  1617. I've seen it randomly crash with a Divide by Zero error.  I don't know if it's 
  1618. a bug in the OS/2 product since it was at beta level or in my code.  When I get 
  1619. the chance to debug it on a GA level of OS/2 for SMP, I'll try to track this 
  1620. down. 
  1621.  
  1622.  
  1623. ΓòÉΓòÉΓòÉ 36.11. Icon Problem ΓòÉΓòÉΓòÉ
  1624.  
  1625. Users of certain ATI graphics cards report that the PMMPEG icon is not being 
  1626. displayed properly, instead a generic OS/2 icon is shown. Since this works 
  1627. properly on other systems including XGA and S3, I suspect it's an ATI driver 
  1628. problem. 
  1629.  
  1630.  
  1631. ΓòÉΓòÉΓòÉ 36.12. Many PMMPEG.INI files, options not saved ΓòÉΓòÉΓòÉ
  1632.  
  1633. If you make your own icon for PMMPEG instead of using INSTALL.CMD , make SURE 
  1634. you specify the full path to the PMMPEG.EXE in the Settings page.  If you 
  1635. don't, the Workplace Shell won't pass the path of the executable file to PMMPEG 
  1636. as it's running and you'll end up with PMMPEG.INI files scattered over your 
  1637. hard disk and none of your saved settings will work correctly. 
  1638.  
  1639.  
  1640. ΓòÉΓòÉΓòÉ 37. Author Contact ΓòÉΓòÉΓòÉ
  1641.  
  1642. Author name: Mike Brown 
  1643.  
  1644. You can reach me in one of the following manners: 
  1645.  
  1646.      mbrown@sescomp.com (or use the syntax required by your system to send 
  1647.       Internet email). 
  1648.  
  1649.     
  1650.  
  1651.             SES Computing, Inc.
  1652.             13206 Jenner Lane
  1653.             Austin, TX 78729-7456
  1654.  
  1655.  I look forward to reports of new movie sites, new feature requests and of 
  1656.  course bug reports. 
  1657.  
  1658.  Note: I plan to move my family to Melbourne, Australia in December, 1995 for 
  1659.  two years.  This complicates registering your copy of PMMPEG at that time, 
  1660.  because my email address may not remain the same and I'd probably prefer 
  1661.  Aussie Dollars by then!  I'll work on making it easy for you to register after 
  1662.  this time, but if you have trouble contacting me, please keep trying. 
  1663.  
  1664.  Also, if you've got a job for me doing OS/2 development, PLEASE contact me as 
  1665.  I'd like to get something lined up in lots of time before we head over. 
  1666.  
  1667.  
  1668. ΓòÉΓòÉΓòÉ 38. Registration ΓòÉΓòÉΓòÉ
  1669.  
  1670. Release 1.0 of PMMPEG was distributed as Freeware because it didn't have all of 
  1671. the features that I eventually wanted to include, and I also wanted to gauge 
  1672. the market for such a program.  I have decided to distribute Release 3.0 of 
  1673. PMMPEG as Shareware to recoup some of the development, postage and network 
  1674. costs associated with distributing it. 
  1675.  
  1676. The suggested price is $15.00, a bargain at twice the price!  If after 30 days 
  1677. of use you decide that PMMPEG is a useful tool, please print out the 
  1678. Registration Form and mail it and the registration fee to the address shown on 
  1679. the form. 
  1680.  
  1681. I have specifically not disabled any features, but trust you to "do the right 
  1682. thing" to support development of cheap but useful software in the growing OS/2 
  1683. environment. 
  1684.  
  1685. I'm pleased with the registration rate from PMMPEG 2.1, but I still think there 
  1686. are a lot of folks out there that have forgotten to register, so I decided to 
  1687. add the Registration feature. 
  1688.  
  1689. As a registered user, you are entitled to a free upgrade to the next release of 
  1690. PMMPEG.  You can receive your upgrade in one of the following manners: 
  1691.  
  1692.      Through the post office on a 5╨╝" or 3╨╗" floppy disk. 
  1693.  
  1694.      Through email as a series of UUENCODED email messages. 
  1695.  
  1696.      By ftp from ftp.cdrom.com. 
  1697.  
  1698.  Be sure to completely fill out the form so I can keep you up to date. 
  1699.  
  1700.  
  1701. ΓòÉΓòÉΓòÉ 38.1. Registration Form for PMMPEG Release 3.0 ΓòÉΓòÉΓòÉ
  1702.  
  1703. To print this registration form, click on the Print... button below, make sure 
  1704. 'This Section' is selected and then click on Print. 
  1705.  
  1706. Send $15 (plus applicable sales tax if you live in Texas) in a check or money 
  1707. order in U.S. funds drawn on a U.S. bank - sorry my bank is VERY cranky!) with 
  1708. this completed form to 
  1709.  
  1710. SES Computing, Inc.
  1711. 13206 Jenner Lane
  1712. Austin Texas 78729-7456
  1713.  
  1714. Name                ______________________________________________
  1715.  
  1716. Address             ______________________________________________
  1717.  
  1718. State/Province      ______________________________________________
  1719.  
  1720. Country             ______________________________________________
  1721.  
  1722. Zip/Postal Code     ______________________________________________
  1723.  
  1724. Internet/Compuserve ______________________________________________
  1725.  
  1726. Where did you get PMMPEG? ________________________________________
  1727.  
  1728. How would you like to receive your free next release?  (Circle one)
  1729.  
  1730. 5╨╝" Floppy   3╨╗" Floppy   UUENCODED Email   FTP from ftp.cdrom.com
  1731.  
  1732. If you circled UUENCODED Email or FTP, be sure to show an email address above 
  1733. to allow me to deliver the new version or notify you by email that a new 
  1734. version is available. 
  1735.  
  1736. Your signature below acknowledges the following: 
  1737.  
  1738. USERS OF PMMPEG MUST ACCEPT THIS DISCLAIMER OF WARRANTY 
  1739.  
  1740. PMMPEG is supplied 'as is'.  The author disclaims all  warranties, expressed or 
  1741. implied, including, without limitation, the warranties of merchantability and 
  1742. of fitness for any purpose.  The author assumes no liability for damages, 
  1743. direct or consequential, which may result  from the use of PMMPEG.  In any case 
  1744. the  maximum liability of the  seller will be limited exclusively  to product 
  1745. replacement  or refund of  the purchase price. 
  1746.  
  1747. Your signature   ______________________________________________
  1748. Thank you for registering PMMPEG, Mike Brown. 
  1749.  
  1750.  
  1751. ΓòÉΓòÉΓòÉ 39. Credits ΓòÉΓòÉΓòÉ
  1752.  
  1753. Thanks to the following people that used previous PMMPEG releases and sent in 
  1754. valuable suggestions, bug reports and beta test feedback. 
  1755.  
  1756.      Que Alexander 
  1757.  
  1758.      Keith Brafford 
  1759.  
  1760.      Charles Buck 
  1761.  
  1762.      R. Campbell 
  1763.  
  1764.      Troy Caperton 
  1765.  
  1766.      Les Chan 
  1767.  
  1768.      Michael Chan 
  1769.  
  1770.      John-Marc Chandonia 
  1771.  
  1772.      Dave Conway-Jones 
  1773.  
  1774.      Linden DeCarmol 
  1775.  
  1776.      Mike W. Dross 
  1777.  
  1778.      Rainer Falkner 
  1779.  
  1780.      Mark Fay 
  1781.  
  1782.      Roger Geer 
  1783.  
  1784.      Tom Giroux 
  1785.  
  1786.      Eric Goodall 
  1787.  
  1788.      Scott Harper 
  1789.  
  1790.      Steve Hancock 
  1791.  
  1792.      Chris Herborth 
  1793.  
  1794.      Wey J Ho 
  1795.  
  1796.      Dzung T. Hoang 
  1797.  
  1798.      Philip Hunter 
  1799.  
  1800.      Rich Iachetta 
  1801.  
  1802.      Scott INTREPID816 
  1803.  
  1804.      Ernst-Walter Joehnk 
  1805.  
  1806.      John Johnson 
  1807.  
  1808.      Scott Jost 
  1809.  
  1810.      Paul Kolenbrander 
  1811.  
  1812.      Fredrik Kvamme 
  1813.  
  1814.      Morris Kwok 
  1815.  
  1816.      Jim Leff 
  1817.  
  1818.      Alann Lopes 
  1819.  
  1820.      Kevin Lowey 
  1821.  
  1822.      Guy McArthur 
  1823.  
  1824.      Gianluca Magalotti 
  1825.  
  1826.      Markus Moenig 
  1827.  
  1828.      Makoto Nagata 
  1829.  
  1830.      John Navarro 
  1831.  
  1832.      Charlie O 
  1833.  
  1834.      Roman Olynyk 
  1835.  
  1836.      Chris Peck 
  1837.  
  1838.      Murray Penney 
  1839.  
  1840.      Mark Pietras 
  1841.  
  1842.      Graham Sanderson 
  1843.  
  1844.      Carl Sayres 
  1845.  
  1846.      Gabriele Sartori 
  1847.  
  1848.      Darren Schultz 
  1849.  
  1850.      James Shoemaker 
  1851.  
  1852.      Greg Spath 
  1853.  
  1854.      Brian Stark 
  1855.  
  1856.      Kevin Sole 
  1857.  
  1858.      Joey Sum 
  1859.  
  1860.      David Sutherland 
  1861.  
  1862.      Gil Tennant 
  1863.  
  1864.      Aldis Valkirs 
  1865.  
  1866.      John VanHoozer 
  1867.  
  1868.      Nicolas Wagrez 
  1869.  
  1870.      John Webb 
  1871.  
  1872.      Ender Wiggin 
  1873.  
  1874.      Elton Woo 
  1875.  
  1876.      Stefan Zollner 
  1877.  
  1878.  
  1879. ΓòÉΓòÉΓòÉ 40. Saving Individual Frames ΓòÉΓòÉΓòÉ
  1880.  
  1881. This feature allows you to save the curently displayed frame to the Clipboard 
  1882. or as an OS/2 Bitmap file These toolbar buttons are disabled during playback. 
  1883.  
  1884.  
  1885. ΓòÉΓòÉΓòÉ 41. 256 Colors ΓòÉΓòÉΓòÉ
  1886.  
  1887. The dithering code in PMMPEG (both in DIVE mode and non-DIVE mode) requires the 
  1888. hardware be configured to display at least 256 colors or truly awful images are 
  1889. produced.  If less than 256 color capability is detected at startup, a message 
  1890. will be displayed to that effect and the program will exit. 
  1891.  
  1892.  
  1893. ΓòÉΓòÉΓòÉ 42. Slideshow ΓòÉΓòÉΓòÉ
  1894.  
  1895. This feature allows you to select multiple files using: 
  1896.  
  1897.      The File Dialog 
  1898.  
  1899.       You can select multiple files using the File Dialog and they will be 
  1900.       played in the order they are shown in the list, not in the order that 
  1901.       they were clicked on. 
  1902.  
  1903.      Drag/drop multiple files from somewhere on the desktop 
  1904.  
  1905.       You can drag and drop multiple files from anywhere on the desktop. The 
  1906.       files will be played in an indeterminate order as the container that 
  1907.       you're dragging from will generate the list of files which will not 
  1908.       necessarily correspond to the manner in which you selected the files. 
  1909.  
  1910.      Filenames on the command line. 
  1911.  
  1912.       You can specify multiple filenames on the command line when you launch 
  1913.       PMMPEG. 
  1914.  
  1915.  PMMPEG will then play each movie, one after the other, and optionally loop 
  1916.  back to the front of the list and play again if the Loop mode is set. 
  1917.  
  1918.  If a serious decoding error occurs, the slideshow will halt.  You must click 
  1919.  on the Play button to continue playing.  It's not reccommended that MPEG files 
  1920.  with known encoding problems be selected in a slideshow as it will halt 
  1921.  playback each time the decoding error occurs.